home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / tab_plot.zoo / tab_plot.txt < prev    next >
Text File  |  1992-10-20  |  8KB  |  164 lines
  1.         TAB_PLOT version 2.9  10-92  written by Robert Best
  2.         Aragon 1, NL 3831 ET Leusden, bitnet RWBEST@SARA.NL
  3.  
  4.         What's new recently?
  5.  
  6. Makes skew XYZ plots. Swaps X- and Y-axes in XYZ plots.
  7.  
  8.         What does TAB_PLOT?
  9.  
  10. TAB_PLOT converts a number table, contained in the output file of another 
  11. program, into a XY, RΦ, XYZ or RΦZ plot. Automatic (log)scaling, spline 
  12. interpolation, curve fitting, hidden surface, contour plot, plot sizing 
  13. and PostScript output are included.
  14. TAB_PLOT does not make bar graphics or pie charts.
  15.  
  16. To see how it works, run TAB_PLOT.PRG and select example TABLEXY; a plot 
  17. will appear under a menu bar. Try a few items. Quit is the last menu item. 
  18. If TAB_PLOT.TXT (this file) is selected, TAB_PLOT asks 'XY or XYZ plot?'. 
  19. Click on XY and type [Return] to see this file again. Use the arrow-down 
  20. key to find the table below and select (arbitrarily) columns for X and Y.
  21. The same table in TAB_PLOT.TXT can be used to plot a curve in XYZ space 
  22. by selecting 'XYZ'. Try 'Spline'. With TABLEXYZ, XYZ and RΦZ plots can 
  23. be made in 3-dim. or contour if you select 'XYZ' and 'surface'.
  24.  
  25. There are 3 initial plot types: XY-curve, XYZ-curve and XYZ-surface. Use 
  26. 'Next' if you have the wrong one. From an initial plot you may proceed to 
  27. RΦ-curve, RΦZ-curve, RΦZ-surface and XYZ- or RΦZ-contour plots.
  28.  
  29. There are 2 ways to plot >1 curves in a XY plot. Use 'Columns' if all 
  30. curves are defined by common X values, use 'More' if they are not.
  31.  
  32.         Initial plot
  33.  
  34. TAB_PLOT counts rows and columns of the table. If it has just 2 columns, 
  35. like TABLEXY, the first is taken as X- and the second as Y-coordinates.
  36. If it has more columns, TAB_PLOT asks 'XY or XYZ plot?'.
  37. If it has just 3 columns and 'XYZ' is chosen, the first two columns are 
  38. taken for X and Y values, and the 3rd for Z. Then TAB_PLOT asks 'curve' or 
  39. 'surface' unless the table does not qualify for a surface plot.
  40. If it has >2 (case XY) or >3 columns (case XYZ-surface), TAB_PLOT asks to 
  41. select columns for X and Y (see 'Columns' below) or for Z ('Z-column').
  42. TAB_PLOT determines the range of X, Y (and Z) values for scaling. 
  43. The choice between XY and XYZ leads to different sets of menu items.
  44.  
  45.         XY menu
  46.  
  47. Most items are evident. Just try. Further information:
  48. RΦ: takes X values for Φ and Y values for R. Selectable only if all 
  49.      R values are non-negative. Y2 values (see 'Columns') are ignored.
  50. Fit: linear, exp., log. or power fit depending on X and Y (log)scales.
  51.      Not selectable for RΦ curves.
  52. Size: in upper left corner in pixels, or in inch/100 for PS print. 
  53.      Click when size is right. Adjust text if necessary.
  54. Save: store data of current plot in TAB2PLOT file (see below).
  55. Degas: save as Degas file. Does not work properly on TT.
  56. Print: screen dump. Does not work on TT.
  57. PS:  save plot in PostScript for printer or TeX.
  58. Xmin: minimum value on X-axis. Must be less than Xmax. Xmin must be 
  59.      positive if Xlog is active. See 'Pi' below.
  60. Xdiv: number of divisions along linear X scale.
  61.      Not selectable if Xlog is active.
  62. Xlog: logscale on X-axis. Selectable only if all X values (in the column) 
  63.      and Xmin are positive.
  64. Xrev: reverse X scale. Not selectable and inactive if Xlog is on.
  65. Xmul: multiply all X values by positive factor.
  66. Text: type _ or ^ preceding a character to make it sub- or superscript.
  67.      See 'Font' below.
  68. Text movable: position with mouse and click. Max. 20 texts of 30 characters.
  69. Columns: make new plot, one or more curves related to Y1 (left hand 
  70.      Y scale) and zero or more curves related to Y2 (right hand Y scale).
  71.      Type column numbers for Y separated by any non-number character.
  72.      Not selectable and inactive after 'More'.
  73. Length: make new plot using same but shorter columns. 
  74.      Not selectable and inactive after 'More'.
  75. More: plot all tables in the file. 1st column for X, 2nd column for Y. 
  76.      Selectable only and once for 2-column tables. 
  77. Next: select another table, or another initial plot. 
  78.  
  79.         XYZ menu
  80.  
  81. Similar to the XY menu. Further information:
  82. Contour: The Z-values of the contours are equal to the values along the 
  83.      Z-axis of the 3 dim. plot. Use movable text to label the curves. 
  84.      Not selectable for 'Scenes' or 3-dim. curve plot.
  85. RΦZ: takes 1st column for R and 2nd column for Φ. Selectable if all 
  86.      R values are non-negative and 'Scenes' is not active.  In addition, 
  87.      all Φ values should be between 0 and 2π for a surface plot.
  88. Scenes: alternative XYZ surface plot. Not selectable for other plots.
  89. Hidden: surface. Not selectable for other plots.
  90. Dashed: hidden surface. Not selectable for other plots.
  91. Spline: interpolated values are stored to speed up plotting. Using 'Save' 
  92.      and 'Next' the interpolation can be repeated until memory runs out.
  93. Project: 3-dim. curves. Not selectable for other plots.
  94. Mirror: selectable for surface with Zmin=0. Not for scenes.
  95. Skew: XYZ plots. Set -1 < Skew < 1.
  96. Xrev, Yrev, Zrev, X<->Y: to get 16 views at an XYZ curve or surface.
  97.      X<->Y is not selectable for contour plots.
  98. Z-column: new plot using other Z values. Selectable if the table has more 
  99.      than 3 columns for surface plots.
  100.  
  101.         Pi
  102.  
  103. Numbers along axes (linear scales) are divided by π if the lower or upper 
  104. bound is specified as a multiple of π/4 using >2 decimals.
  105.  
  106.         Font
  107.  
  108. Corresponds to standard postscript fonts. To get Greek letters, type 
  109. backslash \ followed by
  110. a alpha    A Alpha     j phi1    J theta1     s sigma    S Sigma
  111. b beta     B Beta      k kappa   K Kappa      t tau      T Tau
  112. c chi      C Chi       l lambda  L Lambda     u upsilon  U Upsilon
  113. d delta    D Delta     m mu      M Mu         v omega1   V sigma1
  114. e epsilon  E Epsilon   n nu      N Nu         w omega    W Omega
  115. f phi      F Phi       o omicron O Omicron    x xi       X Xi
  116. g gamma    G Gamma     p pi      P Pi         y psi      Y Psi
  117. h eta      H Eta       q theta   Q Theta      z zeta     Z Zeta
  118. i iota     I Iota      r rho     R Rho  
  119.  
  120.         Number table
  121.  
  122. Example
  123. =======
  124. 0   1.1        0.027324
  125. 1   1.9415    0.082085
  126. 2   2.0093    0.2019        text
  127. 3   1.2411    0.40657
  128. 4   0.3432    0.67032
  129. 5   0.14108    0.90484
  130. 6   0.82058    1
  131. 7   1.757    0.90484
  132. 8   2.0894    0.67032
  133. 9   1.5121    0.40657
  134. 10  0.55598    0.2019
  135. ===
  136. Constraints on the form are minimal, but note the following. 
  137. Numbers in a row must be separated by spaces or tabs (ASCII 32 or 9). 
  138. A row of numbers must be terminated by ASCII 13 because TAB_PLOT uses this 
  139. to count the rows. A row of numbers may be preceded or followed by text and 
  140. other characters, but a dot, digit or minus sign is assumed to start a new 
  141. row of numbers. 
  142. TAB_PLOT scans (the first 10 kB of) the file for a table header ===. 
  143. If it finds ===, everything preceding it is ignored like in this file. 
  144. TAB_PLOT looks again for === at the end of the table and ignores everything 
  145. below that, unless 'More' is selected.
  146.  
  147. The form of the XYZ (or RΦZ) number file has some additional constraints.
  148. The first two columns must contain the X- (or R-) values and the Y- 
  149. (or Φ-) values. Moreover, in a file for a contour plot or RΦZ plot, 
  150. from top to bottom the X- or R-values must vary like a saw-tooth and 
  151. the Y- or Φ-values like a step function (see TABLEXYZ).
  152.  
  153. A TAB2PLOT or TAB3PLOT file, created by 'Save', is a special number table 
  154. to store and retrieve a plot for further work. Remove the first line if you 
  155. edit this kind of file.
  156.  
  157.         PostScript
  158.  
  159. The PS print differs slightly from what you see on the screen. The font is 
  160. smaller and proportional. The quadrangles in XYZ or RΦZ plots are drawn 
  161. with thinner lines and clipped at oblique X and Y axes or at the elliptic 
  162. base curve. GFABASIC enables clipping only at rectangles on the screen. 
  163.  
  164.